Composing view URLs
By default, the Meridian Explorer website opens to the Welcome page, where the user can begin browsing and searching the repository. The default URL of the site is: http://<ServerName>/bcenterprise or http://<ServerName>/bcenterprise/home.aspx. Under some circumstances or for some users, you might want the website to open to a specific view with a specific document or object tag filter, optionally disable other navigation, and show the items as thumbnails. You can achieve these and similar results by composing a URL that specifies the view to open and other parameters. You can then place the URL in a hyperlink on a different site or in a shortcut on the user's desktop.
The Meridian Explorer URL accepts the optional parameters described in the following table.
Meridian Explorer URL parameters
|
DEFVIEW
|
Optional display mode in which to show the results pane. May only be used with VIEWID. If this parameter is set to THUMBNAIL, items in the view pane appear as thumbnail images. If this parameter is set to any other or no value, the items appear in a grid view. |
|
DOCFILTER
|
Optional ID of an item filter to apply to the specified view. The filter specifies which documents are included using property matching. If the filter specifies property value criteria, the property values must be specified in placeholders in the URL. The criterion operator in the filter definition will be used and should not be specified in the URL. If no value is specified in the URL for the property value criteria of a filter, the filter always evaluates to True.
|
|
NAVSTATE
|
Optional display state of the navigation pane in the browser. May only be used with VIEWID. If this parameter is set to HIDE, the pane is collapsed and the results pane expands to full window width. If this parameter is set to any other or no value, the navigation pane is visible.
|
|
TAGFILTER
|
Optional ID of an item filter to apply to the specified view. Typically, this filter is used to specify which assets are included using indirect linking. If the filter specifies property value criteria, the property values must be specified in placeholders in the URL. The criterion operator in the filter definition will be used and should not be specified in the URL. If no value is specified in the URL for the property value criteria of a filter, the filter always evaluates to True.
|
|
(missing or bad snippet)
UPLOAD
|
When set to 1, the Upload button will be available in the toolbar of the Related Documents page. When set to 0 (default), the button is not shown. This parameter is intended for use when the view is shown from within a maintenance management system.
Users can click the button to upload files to the Meridian Enterprise source vault of the repository. The files will be uploaded to the first vault that is a source of the synchronization job of the repository. You cannot specify one vault from among multiple sources. If no source vault is configured for the synchronization job, an error will occur.
The Meridian Explorer web application web.config file should also be modified to configure the maximum acceptable file size (in KB) to upload, similar to the following. Files larger than this will fail to upload. The default is 4096: <httpRuntime maxRequestLength="1048576" />
The AIMS_Attach_Intialize event procedure must also be implemented (to assign a document type to the uploaded documents, for example) as described in the BlueCielo Meridian Asset Management Module Administrator's Guide. The optional AIMS_Attach_Before and AIMS_Attach_After events may also be implemented.
|
|
VIEWID
|
The ID of the view to open. When a document view is specified, all documents will be listed that match the filter specified by DOCFILTER or are related to a tag that matches the filter specified for TAGFILTER. When a tag view is specified, all object tags will be listed that match the filter specified by TAGFILTER or are related to a document that matches the filter specified for DOCFILTER. Required for use with the Meridian Asset Management Module.
|
|
VIEWMODE
|
Optional display mode of the detail pane. If this parameter is set to DETAILS, the details page of the first item in the result set will be shown. |
The view and filter IDs can be found in Meridian Enterprise Server Configurator as the names that are automatically assigned to them.
Following are some examples of using the client URL parameters.
Open the view named DOC_E915:
http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5
Open the view named DOC_E915 and apply the document filter named 123456.
http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456
Open the view named DOC_E915 and apply the tag filter named 222222:
http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&TAGFILTER=222222
Open the view named DOC_E915, apply the document filter named 123456, and apply the tag filter named 222222:
http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456&TAGFILTER=222222
Open the view named DOC_E915, apply the document filter named 123456, and pass the value ABC for the filter criterion with property SITEID:
http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456&SITEID=ABC
Open the view named DOC_E915, apply the document filter named 123456, pass the value ABC for the filter criterion with property SITEID, hide the navigation pane, and display the results pane in thumbnail mode:
http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456&SITEID=ABC&NAVSTATE=HIDE&DEFVIEW=THUMBNAIL